Touhou Project All-In-One Pack, ver. 2021-05-18 Table of Contents: 01) Intro 02) Playing PC-98 Games 03) Using vpatch 04) Using thcrap 05) Auxiliary Tools a) Using the DirectX Converter b) Using the Key Remapper c) Using DiskExplorer 06) Netplay Tools a) Using RollCaster b) Using Adonis c) Using SokuRoll d) Using the AoCF Netplay Patch 07) Important Notes - TH04 - TH05 - TH06 - TH09 - TH10.5 - TH12.3 - TH15.5 - Windows Games - All Games - thcrap 08) Running Games in Fullscreen 09) Tips for New Players 10) Running Games on Linux 11) Links 01) Intro This pack is intended to be a 'one-stop shop' for anyone wishing to play the official Touhou Project games in English and/or Japanese. It should allow a complete, optimal playing experience, without having to track down and install a dozen different patches and tools separately. As of this version, it includes: - Original Japanese versions of every official game to date - English-patched versions of every game from 1 through 13.5 - The latest build of thcrap, for playing 14 and onward in English - Neko Project II, a PC-98 emulator for playing 1 through 5 - Vpatch, which provides various utilities for older Windows games - A DirectX converter, for fixing some serious issues in Windows 10 - A key remapper, for custom controls or playing on non-QWERTY keyboards - DiskExplorer, a utility for viewing and editing PC-98 disk images - Rollcaster, a netplay utility for 7.5 - Adonis, a netplay utility for 9 - SokuRoll, a netplay utility for 12.3 - The AoCF Netplay Patch for 15.5 - This readme, which explains how to use everything 02) Playing PC-98 Games The version of Neko Project II (fmgen build) included in this release has been pre-configured specifically for playing Touhou, so no setup is necessary unless you'd like to enable bonus features. (See the Links section for more on that.) To launch a game: - Open the emulator, np21nt.exe. - Go to Harddisk > IDE #0 > Open..., and select the game (.hdi) file. - Go to Emulate > Reset. 03) Using vpatch Playing older Windows games through vpatch reduces input lag, allows the games to played in a window of arbitrary size, and fixes a few odd bugs in specific games. Though it's called a patch, it doesn't affect the existing game files, and instead runs alongside the game. The full instructions can be found in the vpatch folder's readme files, but for a basic summary: - Copy vpatch.exe, the game-specific .dll file, and vpatch.ini into the game folder. - Edit vpatch.ini to change your desired settings. Most of them are self- explanatory. - To play English-patched versions, change the name of the game executable to th##.exe. (You can change the Japanese versions to whatever else, such as th##j.exe.) - Launch vpatch.exe, rather than the game executable, to play. Additional setup is necessary for 6; see the Notes section for details. A separate version of vpatch is required to use alongside Adonis; see the Notes section for details. In this release, vpatch has already been added to and configured for 6, 7, 8, 9, 9.5, and 10. Files for other games are available in the vpatch folder. 04) Using thcrap The Touhou Community Reliant Automatic Patcher is a tool which translates games by dynamically patching them as they run. This has generally replaced the old system of hard-patched versions as the way to play Touhou in English. Full instructions are on their site, but you can get started by running thcrap_configure.exe (in the thcrap folder) and following the directions from there. 05) Auxiliary Tools 05a) Using the DirectX Converter The DirectX converter replaces certain functions of the DX8 library with versions from DX9. This is mainly intended to fix the issue of uncapped framerate when playing 6 on Windows 10. To use it, simply place both included files into the game folder. In this release, the converter has not been added to 6 by default, since it should only be used if necessary. 05b) Using the Key Remapper The key remapper is a simple but powerful tool which remaps keyboard inputs. This is useful for playing Touhou on non-QWERTY layouts, or just for setting up custom control schemes. The remapper affects your whole system, so it can be launched at any time before or after launching a game. To configure which keys are remapped to which inputs, simply edit Remap_Keys.ini before launching. It's thoroughly commented, so everything should be obvious. 05c) Using DiskExplorer DiskExplorer is a utility for viewing and editing the contents of PC-98 disk images. It can be used to apply patches to, extract score files from, or otherwise mess with the PC-98 games. To open a game: - Launch editdisk.exe. - A file selection dialogue will appear; select the .hdi file. - For the disk type, select Anex86 HDD. - From here, you can drag-and-drop files in and out. Be aware that changes to disk contents are saved on the fly. 06) Netplay Tools 06a) Using RollCaster RollCaster is a tool which enables netplay in 7.5. To use it: - Edit config_rollcaster.ini to change your settings; the file is thoroughly commented, so everything should be obvious. - Launch RollCaster.exe, select the appropriate option (probably host, connect, or spectate), and follow any prompts. - If all goes well, the game will launch and immediately go to the character selection screen. In this release, RollCaster is already added to 7.5. 06b) Using Adonis Adonis is a tool which enables netplay for 9. Two versions are included; the original Adonis has both an English and a Japanese version, while the improved Adonis2 is only in Japanese. Using the program is simple: - Edit adonis_config.ini or adonis2.ini to change your settings, including the game window size and the default IP to connect to. - Launch your chosen version and language of Adonis and follow the prompts. If all goes well, it will launch the game for you and immediately connect, taking you to the difficulty selection screen. If you wish to use Adonis2 with the English-patched version, you'll have to rename th09e.exe to th09.exe. (You can change the Japanese version to whatever else, such as th09j.exe.) If you wish to use vpatch alongside Adonis, a separate version of vpatch is necessary; see the Notes section for details. Keep in mind that 9 and Adonis are known for being finicky, and netplay probably won't work on the first try. Setting the game and Adonis executables to Compatibility Mode for Windows XP or Vista may help. You'll also have to make sure that both players' controls are configured properly. In this release, Adonis is already added to 9. 06c) Using SokuRoll SokuRoll is a popular tool which improves netplay in 12.3. To use it: - Run 'Launch Hisoutensoku + sokuroll.bat', rather than launching the game. (You can also do this manually by first launching the game, then launching SokuRollLoader.exe.) - If it loads properly, the title bar will contain "Ver1.10ac+ R 1.3" - Once it's running, connect through the game as normal; no further special action is necessary. You will only be able to connect to other players who are using SokuRoll. In this release, SokuRoll is already added to 12.3. 06d) Using the AoCF Netplay Patch This patch is a popular tool which improves netplay in 15.5. To use it: - Simply launch th155n.exe, instead of the game executable, to play. - For use with the beta version of the game (see the Notes section), launch th155n_beta.exe instead. - For use with thcrap, place a copy of Netplay.dll in thcrap\bin\ and launch the game via the shortcut as normal. In this release, both versions of the patch are already added to 15.5, and Netplay.dll is already added to thcrap. 07) Important Notes TH04: There are two versions of 4 included in each language; the one marked "(original)" is the untouched original version, while the other has been modified to run correctly on the included build of Neko Project II. You should only use the original version if playing on a different emulator. The modifications in the NPII version don't affect gameplay. TH05: Depending on your emulator and system setup, the English version of 5 may crash after completing the Extra, but before recording the score/ replay. The exact conditions which cause this bug are unknown, so attempt it at your own risk. TH06: To use vpatch with 6, the game executable must be named 東方紅魔郷.exe. (Just in case it doesn't display properly, that's the title, 'Touhou Koumakyou', in kanji. U+6771, U+65B9, U+7D05, U+9B54, U+90F7.) Additionally, if your system locale is not set to Japanese, use AppLocale (or your equivalent software of choice) to launch vpatch. That aside, 6 is notoriously buggy, so you may need to search out troubleshooting tips on the web to fix any issues you run into. TH09: For in-game text to be displayed correctly when using the hard patch, you must install Cirno.ttf to your Fonts directory; merely having it in the game folder won't work. To use vpatch alongside Adonis, swap out the three normal vpatch files which are already included in the folder with the three alternate files located in vpatch\vpatch_adonis\, then launch Adonis as normal. TH10.5: No netplay tools are included for 10.5 because if you want to play 10.5, you should just play 12.3 instead. Anyone who specifically wants to play 10.5 is an Alice player, and should under no circumstances be trusted. TH12.3: Since 12.3 is essentially an expansion pack to 10.5, you'll need to link the two together to have the full roster in 12.3. To do so, edit configex123.ini in the 12.3 folder, and under [th105path], set 'path' equal to the location of your 10.5 folder. (If you put both folders from this release in the same location, and don't rename them, the correct path is already set.) TH15.5: There are two versions of 15.5 included in this pack; one is the latest release version that the updater will fetch, 1.10d, while the other is the latest beta version, 1.19 Beta 4. The beta is recommended both for netplay, since it's the version most people use, and for single-player, due to its numerous improvements. Both versions are included in the same folder; simply launch the corresponding executable to choose between them. Windows Games: Each Windows game includes a "story_e" folder, which contains English versions of whatever plot-relevant information is included with that game, as well as the afterword if it's available. For the fighting games, that also includes material from the official website. All Games: To access config, scores, screenshots, and replays: - For 1 through 5, these are stored in files within the .hdi file, so you'll need DiskExplorer (or a similar tool) to add or remove them. - For 6 through 12.3, 13.5, 14.5, and 15.5, they're stored in the game folder. - For all others, they're stored in ~\AppData\Roaming\ShanghaiAlice. thcrap: To configure thcrap to run games with vpatch, select the vpatch option for those games when detecting them during first-time setup. (You can also modify existing config files; see the Touhou Patch Center's site for detailed instructions.) To do this with 6, a special version of the vpatch .dll is necessary; it has already been included in this release. 08) Running Games in Fullscreen Aside from the newer fighters, all Touhou games are designed to run at a 4:3 aspect ratio. When running them fullscreen on a non-4:3 display, this intended aspect ratio may get ignored, in which case the window will be distorted to match the display's dimensions. If you play on a widescreen display, and fullscreen games aren't letterboxed (ie, with black bars on either side), then your display is not honoring the game's aspect ratio, and you'll have to use GPU scaling instead. Fortunately, this is easy to enable: For Nvidia Cards: - Open the NVIDIA Control Panel by right-clicking on your desktop. - In the left menu, go to Display > Adjust desktop size and position. - Under the Scaling tab, select "Aspect ratio". - In the dropdown below, select "GPU". For AMD Cards: - Open either the AMD Catalyst Control Center or AMD Radeon Settings by right-clicking on your desktop. For CCC: - In the left menu, go to My Digital Flat Panels > Properties. - Under Image Scaling Preferences, check Enable GPU up-scaling. - Below, choose Maintain aspect ratio. For Radeon Settings: - In the top menu, go to Display. - Turn GPU Scaling on. - For the Scaling Mode, select Aspect Ratio. 09) Tips for New Players Hold Shift for focused movement. Before starting a game for the first time, read the manual. Newer games (since 13) have translated in-game manuals, but you can find detailed explanations of mechanics for every game on the Touhou Wiki. Additionally on the Wiki, you can find many optional game tools and modifications not included in this pack, such as 'thprac', which makes practicing easier and more efficient. 10) Running Games on Linux This pack is intended for use on Windows, and as such no guarantees are made regarding running any components on Linux. However, if you wish to attempt it, these procedures should more or less work. More information is available on the Wiki. PC-98 Games: Neko Project II Kai is the recommended emulator. It is not included in this pack; see the Links section. Be sure to use the IA-32 version (xnp21kai) and configure all the necessary settings as with NP2fmgen. Windows Games: In most cases, the games can simply be launched from within their own directories with Wine, for example: $ wine th##e.exe For Japanese versions, the LANG variable should first be set, for example: $ LANG=ja_JP.UTF8 wine th##.exe thcrap: To launch the shortcuts generated by thcrap, use Wine's "start" command. For example, from the shortcut's own directory: $ wine start "th## (en).lnk" Or from anywhere, with an absolute path: $ wine start /unix "/absolute/path/to/th## (en).lnk" Be aware that the included build of thcrap may not be able to connect to the patch server. In such a case, in order to add new patches or update existing ones, you'll have to manually download and add them to thcrap/repos/. 11) Links General information at the Touhou Wiki (English): http://en.touhouwiki.net/wiki/Touhou_Wiki Touhou Patch Center, home of thcrap: https://thpatch.net/wiki/Touhou_Patch_Center Emulating with Neko Project II fmgen: https://www.shrinemaiden.org/forum/index.php?topic=11117.0 Neko Project II fmgen by nenecchi_0505: http://nenecchi.kirara.st/ English patches for 1 through 5 by xJeePx: https://www.shrinemaiden.org/forum/index.php?topic=13903.0 DiskExplorer by junnno: http://hp.vector.co.jp/authors/VA013937/editdisk/index_e.html Vpatch by swmpLV/75E: http://en.touhouwiki.net/wiki/Game_Tools_and_Modifications#Vsync_Patches Key remapper by Mefidex: https://www.shrinemaiden.org/forum/index.php?topic=219.0 DirectX converter by Boris Vorontsov: http://enbdev.com/download_convertor_dx8todx9.htm Rollcaster and other documentation at the Suimusou wiki: http://wiki.mizuumi.net/w/Immaterial_and_Missing_Power/Netplay Sokuroll and other documentation at the Hisouten wiki: https://hisouten.koumakan.jp/wiki/Netplay AoCF Netplay Patch from LunarCast: http://lunarcast.net/aocf.php Detailed documentation at the AoCF wiki: https://aocf.koumakan.jp/ Neko Project II Kai, for Linux: https://domisan.sakura.ne.jp/article/np2kai/np2kai.html https://github.com/AZO234/NP2kai https://aur.archlinux.org/packages/np2kai-git/